home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / misc / prnf246.zip / PRNSERT.DOC < prev    next >
Text File  |  1994-04-05  |  6KB  |  117 lines
  1.  
  2. _______PrnSert                                                           Ver. 1.00
  3.  
  4.  
  5.  
  6. Purpose: PrnSert reads a file & inserts printer instructions from a PrnSet
  7.          data file wherever it finds a PrnSet-style printer instruction.
  8.          It sends the result to a file or to the printer.  The instructions
  9.          must be the same kind PrnSet would accept at the command line, but
  10.          preceded with a downslash: "\"
  11.  
  12. Format:     PRNSERT readfile [outfile] [/D datafile] [/B] [/Nn]
  13.  
  14.          ________         readfile is the file to be read and printed.  You can use a full
  15.                    drive:\path spec, but no wildcards.
  16.  
  17.          _______         outfile is the file or printer to which the output should go
  18.                    (outfile defaults to prn)
  19.  
  20.          ___________     __________         /D datafile (OR /Ddatafile) specifies the file of PrnSet-style
  21.                    printer data to) be used.  (If no extension is given, it
  22.                    supplies ".DAT".  If no /D datfile is given at all, it
  23.                    defaults to PRNSET.DAT)
  24.  
  25.          __         /B means "Batch" - runs without stopping to ask.  For use when
  26.                    running from a BAT file.
  27.  
  28.          ___         /Nn (where n is a number) means print n copies.  (Default is 1)
  29.  
  30. Remarks: PrnSert is a supplement to and parasitic on PrnSet, the universal
  31.          printer setter.  PrnSet sets the printer to print in a specified
  32.          style before you start it printing a file, but once the printing
  33.          starts the print style can't be changed.  PrnSert will read and
  34.          print a file, interpreting PrnSet's kind of printer instruction as
  35.          it goes.  This allows you to put print instructions into the file
  36.          itself to change the style on the fly, while printing.
  37.  
  38.          The instructions you must use are the kind PrnSet accepts from the
  39.          command line (See PrnSet DOC, Section 3.2 on "The Command Line
  40.          Mode"), but PrnSert is a little more restrictive.  The rules go
  41.          like this.  Each command consists of the following (without spaces
  42.          between them):
  43.  
  44.            1.  downslash ("\")
  45.  
  46.            2.  either "+" to turn the mode ON or "-" to turn it OFF.
  47.  
  48.            3.  the first two characters of the name.
  49.  
  50.          If the command takes numbers (like margin setting or line
  51.          spacing), add the following:
  52.  
  53.            4.  upslash ("/")
  54.  
  55.            5.  up to 3 decimal numbers or 2 hex numbers followed by "H".
  56.  
  57.          If you're not sure exactly what the exact names of your printer
  58.          instructions are, you can print out the DAT file you're using.
  59.          Better still, print out a PRNSET.LST file for that data.  Run
  60.          PrnSet with that data file.  Press F3 to get to the configuration
  61. _______PrnSert 1.00                                                         Page 2
  62.  
  63.  
  64.          screen, and press F10 there to make a PRNSET.LST file.  Among
  65.          other things, it will show the two-character key for each command
  66.          in the file and whether the command takes a number.
  67.  
  68. Examples: Here are some examples, using instructions from LQ-800.DAT:
  69.  
  70.             PrnSet Command    PrnSert      What it
  71.             Line Version      Version      does
  72.  
  73.             +ELITE            \+EL         Turn on elite type
  74.             +Condensed        \+co         Turn on condensed type
  75.             +LMargin/8        \+LM/8       Set 8-column left margin
  76.             +180/24           \+18/24      Set 24/180th inch line spacing
  77.             -Cond             \-CO         Turn off condensed type
  78.  
  79.          Notes:
  80.  
  81.             Talking to PrnSet on the command line, you can use the first
  82.             two characters of instruction name and as much of the rest of
  83.             it as you like (e.g.: "LMargin", "LMarg" or "LM").  Talking to
  84.             PrnSert in the text it's to print, you must use just the first
  85.             two characters.
  86.  
  87.             Upper & lower case doesn't matter.
  88.  
  89.             Printing a plain downslash would go wrong if the next charac-
  90.             ters happen to form a print instruction.  To make sure, to
  91.             print a downslash, double it.  "\\" will print as "\", and it
  92.             won't turn the next few characters into a printer instruction.
  93.  
  94.             If you have an appropriate PRNSET.DAT and run PrnSert on this
  95.             file, you'll see what the instructions above do.  Then double
  96.             the downslashes and do it again.  (But, be sure to reset the
  97.             printer, first!)
  98.  
  99.          What instruction symbols are allowed and what they mean is deter-
  100.          mined by the .DAT file used.  You can edit your regular PRNSET.DAT
  101.          file with PrnSert in mind, and there's no reason you shouldn't
  102.          make a special .DAT file for use with PrnSert only.
  103.  
  104. History: PrnSert grew out of a simple label printer which had a set of sym-
  105.          bols to with their corresponding printer instructions hard-coded.
  106.          Whenever I got a new printer, I rewrote the program.  It occurred
  107.          to me that PrnSet's .DAT files already contained printer symbols
  108.          and instructions and I already had the routines for interpreting
  109.          them.  Reused, they form the basis of PrnSert.
  110.  
  111.          PrnSert could have been added as another function in PrnSet, but I
  112.          thought PrnSet already a mite over-featured, and a simple command
  113.          line interface would do the job better.
  114.  
  115.                                                     R. N. Wisan, April 1994
  116.                                           37 Clinton St., Oneonta, NY 13820
  117.                                               internet: WISANR.hartwick.edu